Updating the Nodinite IBM MQ Monitoring Agent
Keep your IBM MQ monitoring up to date and secure with Nodinite. On this page, you will learn how to:
- ✅ Update the IBM MQ Monitoring Agent quickly and safely using the latest MSI package
- ✅ Verify compatibility and versioning for seamless upgrades
- ✅ Maintain secure credentials and compliance throughout the update process
- ✅ Troubleshoot and resolve common update issues
On this page, you will learn how to update the Nodinite IBM MQ Monitoring Agent. You can easily update the IBM MQ Monitoring Agent using the latest software package (MSI).
Release notes
For information about the releases, visit the Release Notes for the IBM MQ Monitoring Agent.
Running Version
You can view the installed version in the 'Version' text box.
Here's where to find the installed version in the agent UI.
You can also check the file details property on the local installation.
Check the file version details on your server for verification.
Compatibility and versioning issues
| Version | Comment |
|---|---|
| 5.3.x | Sensitive information is now encrypted and the configuration file is tied with the service account/password combination. Make sure to store passwords in your password-protected manager. |
PreReq: Before you update, make sure you have successfully installed the Nodinite IBM MQ Monitoring Agent. The Service account credentials you use must have Logon as Service Right. See Prerequisites for IBM MQ Monitoring Agent for more information. You must be a local administrator to install (and thereby update) Windows Services.
Step 1: Start the installer
Double-click the MSI file to start the update process.
Start the update by running the MSI installer.
Depending on your Windows settings, a security warning may appear. Click 'Run' to continue.
Security warning prompt when launching the installer.
Step 2: Welcome Screen
When you successfully execute the MSI file, a Welcome screen appears.
Welcome screen of the IBM MQ Monitoring Agent installer.
Click the 'Next' button to continue with the update process or click the 'Cancel' button to quit the installer.
Step 3: Custom Setup
Select the Components and the Location for the installation. The Default settings are recommended.
Choose components and location for the update.
![!NOTE] If you change the location, you will lose your old configuration.
Click the 'Next' button to continue with the update process or click the 'Cancel' button to quit the installer.
Step 4: Service Account Information
Enter the credentials for the Account that will run the Nodinite IBM MQ Monitoring Agent. Depending on the connection string settings, this account will log on and query the databases being monitored.
Domain: Enter the name of the Domain the Server belongs to. If you use a local account, use the name of the server or a . (dot) as Domain.
User: Enter the name of the account.
Password: Enter the password for the account.
Enter the domain service account credentials for the agent.
Note
The account must have 'Log on as Service Right'.
Click the 'Next' button to continue with the update process or click the 'Cancel' button to quit the installer.
Insufficient Privileges
If the account information does not meet Prerequisites, you will see an error message.
Example of insufficient privileges error during update.
If you see this message, the most common reason is that the account is not allowed to run as a service or is not a local Administrator on the server. Follow the guide How to set Logon as a Service right and click retry. If the problem remains, click cancel and restart. Make sure you enter valid credentials!
Tip
Check the local event log if you see errors (both System and Application).
Step 5: Completed setup
The last step of the update process gives either a success or a premature exit.
Successful update example.
If the update fails, you will see a premature exit.
Example of a failed update with premature exit.
Click the 'Finish' button to exit and quit the installer (update process).
When the setup finishes, the default text editor opens a text file named 'README.txt'. The README.txt file holds additional information you need to manage the agent as a Monitoring Agents.
README.txt file with post-update information.
Support
If you fail to resolve the update problem, contact our Support.
Note
Additional information to aid troubleshooting may exist in the Windows Event Logs.
Next Step
Add or manage a Monitoring Agent Configuration
Configuration of the agent
Install IBM MQ Monitoring Agent
Uninstall